home *** CD-ROM | disk | FTP | other *** search
/ PC World 2006 September / PCWorld_2006-09_cd.bin / v cisle / samurize / samurize_1.64.exe / Scripts / Extended Drive Props Readme.txt next >
Text File  |  2003-03-21  |  8KB  |  153 lines
  1. 'Extended Properties Information VBScript
  2. 'Version 1.5
  3. 'Created 4th June 2002
  4. 'Last Modified 19th March 2003
  5. 'Copyright 2003, Rowan Gillson
  6. 'Not redistrubtable without express permission from author.
  7. 'Suitable for Windows 2000/Windows XP only.
  8. '
  9. '
  10. 'comments to r_gillson@hotmail.com or ICQ # 14894674
  11.  
  12. Contents:
  13. 1. Install Notes.
  14.     1.1 General Notes
  15.     1.2 Usage Notes
  16.     1.3 ExtendedProps Notes
  17.     1.4 ExtendedDrive Notes
  18.     1.5 Script Execution Notes
  19. 2. Version History.
  20. 3. Credits
  21.  
  22. IMPORTANT NOTE!
  23. ExtendedProps 1.5 and ExtendedDrive 1.5 do not work with versions of Serious 
  24. Samurize prior to 0.85b
  25.  
  26.  
  27. -----------------------------------------------------------
  28.  
  29.  
  30. 1. Install Notes.
  31.  
  32. ---------------------------1.1-----------------------------
  33. This package is distributed as a ZIP archive. Please extract directly into your
  34. Samurize scripts folder. After extracting files. Open Samurize and add the scripts
  35. to your config by choosing 'ExtendedProps' or 'ExtendedDrive' from the list of
  36. available scripts.
  37.  
  38. ExtendedProps is a script for providing additional information to Samurize that are
  39. not included within the standard Samurize meters. Some examples of info you can
  40. include are; display resolution, IP address, OS version and Service Pack, video
  41. memory, cpu clock speed, cpu multiplier and many more.
  42.  
  43. ExtendedDrive is a script for providing additional information to Samurize about
  44. your fixed and removable disks. Some examples of info you can include are
  45.  
  46.  
  47. ---------------------------1.2-----------------------------
  48. Another option available now is the ability to monitor a remote computer and display
  49. information across a network. From version 0.85b of Serious Samurize, when u select a 
  50. function from the list after selecting ExtendedProps or ExtendedDrive as your 
  51. ActiveScript, you will be prompted with an input box in which you type in the
  52. name of your computer, or that of another computer on your local area network.
  53. If you are unsure of the network name of your computer, try adding the "ComputerName" 
  54. function as your meter first and click the "Test Script" button. This will display 
  55. your computers network name which you can use in the input box for the other functions.
  56.  
  57. NOTE: All but the following list of functions require the input box variable to be
  58. entered. Functions not requiring parameter are: UserName, ComputerName, DomainName and
  59. PrimaryGroup. For advanced users this means you cannot use these functions on another 
  60. computer on your network (not that it would make sense to anyway).
  61.  
  62.  
  63. ---------------------------1.3-----------------------------
  64. When using the ExtendedProps script you are prompted with 2 parameters for the IPAddress
  65. function. The first parameter you are required to enter is the computername, see above
  66. section 1.2 on determining your computer name. Secondly your are asked for a parameter
  67. labelled "NICIndex" this feature is used for when you have more than one physical network
  68. card located in your computer or the remote computer you are monitoring. By default you
  69. should set this as "1". This will tell the script to you your first available network card.
  70. If you wish to get the IP address of a second network card, change the index number to be 
  71. any other positive integer. If the NICIndex number is invalid you will receive an error
  72. message.
  73.  
  74.  
  75. ---------------------------1.4-----------------------------
  76. When using the ExtendedDrive script you are prompted with 2 parameters on all functions
  77. excluding the last three (3) which are local scripts only and cannot be used on a remote 
  78. computer.
  79.  
  80. The first parameter is the name of the computer you wish to monitor, you can use your local
  81. machine name or the name of another computer on your network. The second parameter is the
  82. drive index number.
  83.  
  84. The drive index numbers start from zero (0) and each PHYSICAL drive is given an index number 
  85. that is incremented from the first. ie. Physical Drive C: is DriveIndex 0, Physical Drive D:
  86. is DriveIndex 1, etc, etc. The emphasis here is on physical drives, if you have paritioned
  87. your hard drive into logical disks then each subsequent partition other than the first will
  88. not receive a DriveIndex and cannot be monitored.
  89.  
  90.  
  91. ---------------------------1.5-----------------------------
  92. When configuring Samurize, it is recommended that you set your script run frequency 
  93. to a value greater than 10 minutes.  I recommend running these script functions once 
  94. every half hour or greater. I also recommend that should you choose to use all of the 
  95. included script functions, that you randmoize the interval at which these functions 
  96. are executed so that no more than 3 functions ever run at the same interval, running 
  97. all the functions at the same interval may cause small system performance decrease 
  98. during the period that the functions execute.
  99.  
  100.  
  101. -----------------------------------------------------------
  102.  
  103.  
  104. 2. Version History
  105.  
  106. 1.5 Rewrote all functions to now support parameter parsing from Samurize. WMI query 
  107. moved into sub procedure and new "ComputerName" variable added which is parsed from
  108. Samurize to allow monitoring of local or remote computers. Added support for more than
  109. one network interface by entering the NICIndex parameter as an integer.
  110.  
  111. BUGFIX: Fixed one of the sub Functions for PrimaryGroup to now be private else it
  112. was showing up in the list of available scripts in Samurize 0.85b
  113.  
  114. 1.4a BUGFIX: Fixed some drive functions causing error in Samurize.
  115.  
  116. 1.4 Added overclocking info for FSB and Multiplier.
  117.  
  118. 1.3 Modified script to reduce lines of code by handling WMI queries better.
  119. Added ability to poll WMI info for remote computers on network for a large number
  120. of functions. Just change the 'strComputer' variable from "." to "computername" to
  121. make this work. Once Samurize has the option of parsing variables to VBScripts this will 
  122. no longer be required. Removed Installer.vbs. You can now copy ExtendedDriveInfo and
  123. replace 'strDriveLetter' variable with the letter of other drives you wish to monitor.
  124. Might seem like a step back but did not feel like re-writing Installer.vbs to handle all 
  125. the code changes to to the script.
  126.  
  127. BUGFIX: Changed CPUSpeed function from CurrentClockSpeed to MaxClockSpeed to handle
  128. problem with Intel Pentium III processor not displaying true clock speed.
  129.  
  130. 1.2 Added additional network information, drive information, environment information
  131. and CPU information functions. Created installer for additional drive information
  132. functions. Installer creates individual scripts for each drive. Was going to add support
  133. for total upload/download on Network Interfaces but under advisement from Cure have left
  134. this info alone because of native implmentation in coming versions of Samurize.
  135.  
  136. NOTE: The function PrimaryGroup() will only work on systems that are a member of a network
  137. domain eg. Windows NT based domain or Windows 2000 Active Directory based domain.
  138.  
  139.  
  140. 1.1 Added CPU information and video display information functions
  141.  
  142. 1.0 Rewrote GetIP script and released as ExtendedProps 1.0
  143.  
  144.  
  145. -----------------------------------------------------------
  146.  
  147.  
  148. 3. Credits
  149.  
  150. Thanks to help from MS Newsgroup posters for help with getting workgroup info for 1.2,
  151. thanks also to Win32 Scripting for resources on getting Primary Group info for 1.2,
  152. thanks to Mardagg and Nahaz for great ideas for version 1.2and last but not least, special 
  153. thanks to Cure & Sim for writing such an awesome program that we can all have fun with.